home *** CD-ROM | disk | FTP | other *** search
/ Experimental BBS Explossion 3 / Experimental BBS Explossion III.iso / chess / mgt.zip / README.IBM < prev    next >
Text File  |  1993-03-13  |  10KB  |  248 lines
  1.                             The IBM Implementation
  2.  
  3. The IBM PC implementation has several features which are absent from the 
  4. UNIX version.  
  5.  
  6.                              Keyboard Extensions
  7.  
  8. The cursor keys work in the editor as cursor keys.
  9.      
  10. When not in the editor, the operation of the cursor keys is controlled
  11. by the _ASCARROW environment string:
  12.  
  13. _ASCARROW:CURSOR
  14.     The PC arrow keys move the board cursor.
  15.  
  16. _ASCARROW:TREE
  17.     The PC arrow keys are used for tree traversing,
  18.     right, left: down tree, up tree (like > and < respectively)
  19.     up, down:    last, next variation branch
  20.     pgup, pgdn:  last, next comment
  21.  
  22. _ASCARROW:MODE
  23.     The operation of the PC arrow keys change depending upon the current
  24.     mgt mode: cursor control in edit mode and tree control in tutor mode  
  25.  
  26.  
  27.                               Display Extensions
  28.  
  29. There are three display modes for the IBM mgt:
  30.     graphics mode, nographics mode, and nocolor mode
  31.  
  32. Graphics mode is the default on VGA or EGA systems.  The board is displayed
  33. using special graphics characters.  The _ASCCHAR
  34. specification is ignored.  Note that despite its name, "graphics" mode
  35. does not use graphics mode.  It uses text mode and redefines the font.
  36.  
  37. In nographics mode, color is used to obtain good contrast between the board 
  38. and the stones.  The "black stone" character is used for both white and 
  39. black stones with different colors.  Similarly, the "black territory" 
  40. marker is used for both white and black territory.  The "white stone" 
  41. character and the "white territory" character are ignored.  
  42.  
  43. Nocolor mode is the pure text display.  The default uses IBM graphics
  44. characters for the borders.  
  45.  
  46. In both nographics mode and nocolor mode, ascii 3 (a heart symbol) is used 
  47. the default for the black stone character.
  48.  
  49. To force nographics mode, put _ASCNOGRAPH in your MGT environment string.  
  50. To force nocolor mode, put _ASCNOCOLOR in the environment string.
  51.  
  52. In either graphics or nographics modes, the display colors can be set 
  53. through these environment strings:
  54.   _ASCBCOL:   black stone color
  55.   _ASCWCOL:   white stone color
  56.   _ASCDAME:   dame color
  57.   _ASCBOARD:  board color
  58.   _ASCBG:     background
  59.   _ASCFG:     foreground
  60.   _ASCMARK:   mark color
  61.   _ASCLET:    letter color
  62.   _ASCMENUFG: menu foreground
  63.   _ASCMENUBG: menu background
  64.  
  65. The colors are:
  66.     0   black         8   dark gray    
  67.     1   blue          9   light blue   
  68.     2   green         10  light green  
  69.     3   cyan          11  light cyan   
  70.     4   red           12  light red    
  71.     5   magenta       13  light magenta
  72.     6   brown         14  yellow       
  73.     7   light gray    15  white        
  74.  
  75. To choose the defaults, you would execute the command:
  76.  
  77. set MGT=_ASCBCOL:0 _ASCWCOL:7 _ASCDAME:1 _ASCBOARD:6 _ASCBG:0 _ASCFG:0
  78.         _ASCMARK:9 _ASCLET:1 _ASCMENUFG:2 _ASCMENUBG:0
  79.  
  80. (You don't need to do this if you like the defaults.)
  81.  
  82. The _ASCINV environment item will swap the foreground and background, and 
  83. set the menu background to the background.  This is equivalent to pressing 
  84. '&' from within mgt.
  85.  
  86. If you run mgt in graphics mode with a VGA, color 6 is changed to a brown 
  87. shade defined by red, green and blue components: 
  88.         _RED:39 _BLUE:5 _GREEN:33
  89. This color is meant to be used for the board.  Other colors for color 6 can be 
  90. selected by specifying different values for red, green and blue in the 
  91. environment.  The range is 0-63.  
  92.  
  93. One person thought _RED:40 _GREEN:30 _BLUE:14 with the background
  94. inverted looked better than the defaults.
  95.  
  96. A CGA user suggests the following combination:
  97.                  _ASCBOARD:5 _ASCMARK:4 _ASCLET:2   
  98.  
  99. Some text, CGA and LCD portable users may want to use the _ASCCHAR
  100. string to set the Stones and board characters to some of the "special"
  101. IBM PC characters.  The black and white smilie faces may be better for
  102. some as the stone characters.  There are single line and double line
  103. border characters.  A "dot in the middle" character seems to work well
  104. for the empty points on the board.  These characters may be entered on a
  105. PC with the following key sequence: 
  106.  
  107.               <press and hold Alt>nnn<release Alt>
  108.  
  109. The nnn represents a 1 to 3 digit decimal value for the character
  110. entered on the numeric keypad (the number keys across the top do not
  111. work.)  The following "special" values seem to work well:
  112.  
  113. Black stone:  2
  114. White stone:  1
  115. Empty point:  249
  116. Vert. border: 179 or 186
  117. Horz. border: 196 or 205
  118. Upper left:   218 or 201
  119. Upper right:  191 or 187
  120. Lower left:   192 or 200
  121. Lower right:  217 or 188
  122.  
  123. The first column is for a single line border and the second column is
  124. for a double line border.
  125.  
  126. The sequence of characters after "_ASCCHAR:" is: black stone (002),
  127. white stone (001), dame territory ('?'), black territory ('+'), white
  128. territory ('-'), empty points (249), hosi points ('+'), vertical
  129. border (186), horizontal border (205), upper left corner (201),
  130. upper right corner (187), lower left corner (200), lower right corner
  131. (188).
  132.  
  133. In nograph mode the board border characters are ignored, but the stone,
  134. empty point, hoshi points and territory points may be set. In nocolor
  135. mode all may be set.
  136.  
  137.                                 Mouse Support
  138.  
  139. The mouse cursor is an arrow in EGA or VGA modes.  If you don't want the 
  140. arrow, put _ASCMOUSENORM in the environment variable.  
  141.  
  142. The mouse can be used to click on menus, or to click on various parts of 
  143. the board. 
  144.  
  145.  
  146.  
  147. The top line contains various mode listings.  
  148.  
  149.     help quit stone walk move
  150.  
  151. Clicking on help or quit gets help or quits.  
  152.  
  153. The third word indicates the mode for placing items on the board.  In stone 
  154. mode, the left mouse button plays a stone on the board, and the right mouse 
  155. button sets a stone on the board.  (Equivalent to space, and either z or x 
  156. respectively.)  The color of the stone set is determined by the player 
  157. indicator in the lower right corner of the screen.  Clicking on the word 
  158. "stone" on the top line will change it to "mark".  In this mode, the left 
  159. mouse button sets or unsets letters on the board and the right mouse button 
  160. sets and unsets marks.  
  161.  
  162. The fourth item on the top line is either "walk" or "branch" to indicate the 
  163. type of game tree traversal.  In walk mode, clicking with the left button 
  164. anywhere on the variation window moves down the tree (like the > key).  In 
  165. branch mode, clicking on a specific variation visits that variation (like 
  166. pressing capital letters).  In branch mode clicking on blank parts of the 
  167. variation window does nothing.  In either of these modes, right clicking moves 
  168. back up the tree.  
  169.  
  170. The last mode indicator on the top line identifies the menu choice.  
  171. There are four different menus you can choose:
  172.  
  173. move:  start end var comment
  174.  
  175. This is the default menu.  Clicking on start or end moves to the start of the 
  176. game record or the end of the current variation (like the b and e keys).  
  177. Left clicking on var or comment goes to the next variation branch or the next 
  178. comment.  Right clicking on either one goes to the previous variation branch 
  179. or comment.  
  180.  
  181. play: score pass player
  182.  
  183. These menu items score the game, pass a move (like p key) or set the player 
  184. (like the o key), actually changing the Smart-Go record to specify the current 
  185. player.  
  186.  
  187. edit: info cut paste delnode addvar
  188.  
  189. These items invoke the info, cut, paste, delete node, and add variation 
  190. commands.  
  191.  
  192. file: save load next prev
  193.  
  194. These save the game record, load a file, move to the next, or the previous 
  195. file.  Some loading commands are available directly from the screen.
  196. If you loaded mgt with 2 or more files, then left clicking on the filename at 
  197. the upper right will move to the next file, and right clicking will move to 
  198. the previous file.  If you specified only one file, then clicking on the 
  199. filename will load a new file (by name).  
  200.  
  201.  
  202. To scroll the comment window or variation windows with the mouse, click on the 
  203. '+' or '-' character.  
  204.  
  205. To edit a comment, click on the comment window.  To move to a node by number, 
  206. click on the word "node" above the variation window, and to set the node name, 
  207. click on the node name above the variation window.
  208.  
  209. To select the stone color (like the 't' key) click on the stone that is 
  210. displayed on the lower right corner of the screen.
  211.  
  212. At any (y/n) query, press the left button once to get a 'y' and a second time 
  213. to get a return.  Pressing the right button twice gets a 'n' and return.  
  214. Pressing one button and then the other gets either 'y' or 'n', and then a 
  215. backspace to remove the character that is there.  
  216.  
  217. When scoring a game, press right button to score, left button to kill, or
  218. click on the words at the bottom of the screen to undo, quit, or score.
  219.  
  220. Click on the word "tutor" to leave tutor mode, and click on "read" or "edit" 
  221. to enter tutor mode.  
  222.  
  223. Click on the word "short" or "long" to toggle the save format for Smart-Go 
  224. files between short and long.
  225.  
  226. The mode line above the board and the menu line below the board are
  227. omitted if a mouse is not detect on the PC.  All of the functions
  228. performed with the mouse have equivalent key commands.
  229.  
  230.  
  231.  
  232.               Conversion to Short Format
  233.  
  234. A batch file called "mgtshort.bat" is included with mgt.  You invoke
  235. it as
  236.         mgtshort filespec
  237. where the filespec is either a single file or single wildcard specification.
  238. The batch file then invokes mgt on each file, and instructs mgt to save the
  239. file in short format.  
  240.  
  241. This removes any data from the file which mgt did not recognize.  Be careful
  242. with this program, since it will destroy any files which are not Smart-Go. 
  243.  
  244. To install it, you need to edit the file mgtshort.bat to refer to the
  245. permanent location of the mgtshort.cmd file.  
  246.  
  247.  
  248.